home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / patch.arc / PATCH.DOC < prev   
Encoding:
Text File  |  1985-07-01  |  9.9 KB  |  287 lines
  1. PATCH - A tool for the IBMPC       (C) 1983 MicroLife
  2.  
  3.     TABLE OF CONTENTS -
  4.                                                             PAGE
  5.  
  6. Introduction................................................  2
  7.  
  8. Equipment required..........................................  2
  9.  
  10. Operation (To edit a file)..................................  3
  11.  
  12. Operation (To edit a disk)..................................  4
  13.  
  14. The Display (What do all of those numbers mean).............  5
  15.  
  16. Function key [F1] (Abort)...................................  6
  17.  
  18. Function key [F4] (Reset)...................................  6
  19.  
  20. Function key [F5] (Exit)....................................  6
  21.  
  22. Function key [F9] (Text/Hexadecimal mode)...................  7
  23.  
  24. Function key [HOME],[Ctrl-HOME].............................  7
  25.  
  26. Function key [END],[Ctrl-END]...............................  7
  27.  
  28. Function key [PgUp],[Ctrl-PgUp].............................  8
  29.  
  30. Function key [PgDn],[Ctrl-PgDn].............................  8
  31.  
  32. Function key [UP-CURSOR]....................................  8
  33.  
  34. Function key [DOWN-CURSOR]..................................  8
  35.  
  36. Function key [LEFT-CURSOR]..................................  8
  37.  
  38. Function key [RIGHT-CURSOR].................................  8
  39.  
  40. Function key [Alt-S] (Select sector for display)............  9
  41.  
  42. BUGS !...................................................... 10
  43.  
  44. INTRODUCTION:
  45.  
  46. PATCH is a utility program for the IBM Personal Computer.
  47. It was written using the  IBM  Macro  Assembler for speed
  48. enhancement.  PATCH  provides  the user  with the ability
  49. to  display and modify any byte  in a disk or  file.  Two
  50. types  of input  are accepted, Hexadecimal characters, or
  51. almost any  key stroke from the keyboard. PATCH's display
  52. is unlike most  other disk  and file  editors, in that it
  53. displays a 256 byte window of  data, and uses  the cursor
  54. keys to position the cursor over the byte to be modified.
  55. The display is split into two parts.  The left portion of
  56. the screen displays the data in  hexadecimal  characters.
  57. The right  portion displays  the character  equivelent of
  58. each byte.  As mentioned earlier, there are two  modes of
  59. input used, hexadecimal  characters or  text  characters.
  60. In the hexadecimal mode, the right  portion of the screen
  61. is used, while in text mode the left portion is used.  In
  62. either mode, the corresponding byte or character  blinks.
  63. Patch can edit single or double sided disks.
  64.  
  65. Since PATCH is a visual editor, it is easier to  use then
  66. it is to describe how to use it. It is highly recommended
  67. that you read  the description of each  function key, and
  68. practice on a scratch disk or file, before using PATCH in
  69. an actual edit.
  70.  
  71. ** NOTE **  Numbers are displayed and used in this manual
  72.             in the following format:  27F(639)
  73.                           Hexadecimal(Decimal)
  74.  
  75. EQUIPMENT REQUIRED:
  76.  
  77. The equipment needed to use this program is:
  78.  
  79. IBM Personal Computer with 48K of memory, and 1 disk drive
  80. 80 Column display capability (color or monochrome)
  81. IBM DOS Version 1.00 or 1.10  (single sided disk supplied)
  82.  
  83. *  IBM is a registered trademark of the International Business
  84.                                          Machines Corporation
  85. OPERATION
  86.  
  87. To edit a file with PATCH the command is:
  88.  
  89.        "PATCH Filename.ext"  or  "PATCH A:Filename.ext"
  90.  
  91. The screen should look as follows:
  92.  
  93. To edit a disk with PATCH the command is:
  94.  
  95.        "PATCH A:" to edit disk in drive A.
  96.  
  97. PATCH will then prompt you to insert the disk to be edited
  98. into the appropriate drive.  To continue, hit any key.
  99. The screen should look as follows:
  100.  
  101. THE DISPLAY - (What do all of those numbers mean)
  102.  
  103.  
  104. To alter a byte or bytes:
  105.  
  106. In Hexadecimal mode:
  107.  
  108. Simply use the cursor keys to position the cursor over the character
  109. to be modified, then enter the new hexadecimal character.
  110.  
  111. In Text mode:
  112.  
  113. Simply use the cursor keys to position the cursor over the character
  114. to be modified, the hit the key of the new character.
  115. Special characters can be entered just by hitting the equivalent
  116. keystroke.  (For a list of characters and their keystroke see the
  117.                       IBM Technical Reference Manual).
  118.  
  119. Function key [F1] - Abort
  120.  
  121. Function key F1 is used to abort PATCH.
  122.  
  123. Aborting PATCH means the currently displayed sector will remain
  124. unchanged and PATCH will return to DOS.
  125.  
  126. ** NOTE **  This does not mean the file or disk will remain
  127.             unchanged, only the sector currently being displayed!
  128.             This means that if you have already changed a byte in
  129.             another sector it will remain changed.  PATCH writes
  130.             modified sectors back to the disk when another sector
  131.             is displayed.
  132.  
  133. Function key [F4] - Reset
  134.  
  135. Function key F4 is used to reset the currently displayed sector.
  136.  
  137. If after changing a byte or bytes on the display you discover an
  138. error, just hit F4 and PATCH will reset the displayed sector to
  139. what it originally was.
  140.  
  141. Function key [F5] - Exit
  142.  
  143. Function key F5 is used to exit PATCH and return to DOS.
  144.  
  145. Hitting F5 will write the currently display sector, if it has been
  146. modified, out to the disk, (close the file if patching a file),
  147. then return to DOS.
  148.  
  149. Function key [F9] - Text/Hexadecimal mode
  150.  
  151. Function key F9 is used to flip the mode back and forth between
  152. Text mode and Hexadecimal mode.  PATCH initially is in the
  153. Hexadecimal mode.
  154.  
  155. Upon hitting F9, the menu on the lower portion of the screen
  156. will be changed to reflect the operation that will occur when
  157. F9 is hit again.
  158.  
  159. Function key [HOME],[Ctrl-HOME]
  160.  
  161. Function key HOME is used to set the display sector to relative
  162. sector 0.
  163. For a file, the first sector in the file.
  164. For a disk, the first sector on the disk.
  165.  
  166. Function key Ctrl-HOME is used when patching a disk.  Its
  167. function depends on the type of disk that is being patched.
  168.  
  169. For single sided disks, the operation is not accepted.
  170.       (You will hear a beep for keys not accepteL⌐ä
  171.  
  172. For double sided disks, hitting Ctrl-HOME sets the display sector
  173. to relative sector 140(320).  This is the first sector on side 2.
  174.  
  175. For files, the operation is not accepted.
  176.  
  177. Function key [END],[Ctrl-END]
  178.  
  179. Function key END is used to set the display sector to the end
  180. of the file or disk.
  181. For a file, it sets the display sector to the last sector in the file
  182. For a disk, it sets the display sector to the last sector on the disk
  183.  
  184.  
  185. Function key Ctrl-END is used when patching a disk. Its operation
  186. depends on the type of disk being patched.
  187.  
  188. For single sided disks, hitting Ctrl-END is not accepted.
  189.  
  190. For double sided disks, hitting Ctrl-END sets the display sector
  191. to relative sector 13F(319). This is the last sector on side 1.
  192.  
  193. For a file, hitting Ctrl-END is not accepted.
  194.  
  195. Function key [PgUp],[Ctrl-PgUp]
  196.  
  197. Function key [PgUp] is used to display the previous 256 bytes.
  198.  
  199. There are two pages for each sector.
  200.  
  201. Page 0 - Bytes 000(000) - 0FF(255)
  202. Page 1 - Bytes 100(256) - 1FF(511)
  203.  
  204. ** NOTE **  Paging across sector boundries will cause modified
  205.             sectors to be written to the disk.
  206.  
  207. Function key Ctrl-PgUp is similar to PgUp, accept paging is
  208. done 16 pages at a time. This command is a medium-fast
  209. method to arrive at the desired sector to be patched.
  210. (See above note).  (For a faster method, see Alt-S).
  211.  
  212. Function key [UP-CURSOR],[DOWN-CURSOR],[LEFT-CURSOR],[RIGHT-CURSOR]
  213.  
  214. The cursor keys are used to position the cursor over the byte or
  215. character, depending on the mode, to be changed.
  216.  
  217. The UP-CURSOR moves the curosr up.
  218. The DOWN-CURSOR moves the cursor down.
  219. The LEFT-CURSOR moves the cursor left.
  220. The RIGHT-CURSOR moves the cursor right.
  221.  
  222. Function key [Alt-S]
  223.  
  224. Function key Alt-S is a fast, direct way to arrive at the desired
  225. sector to be patched.  Input is accepted in either hexadecimal or
  226. decimal.
  227.  
  228. Upon hitting Alt-S, PATCH will prompt you to enter a relative sector
  229. number.  The prompt is as follows:
  230.  
  231. Enter relative sector # [0 => sector# => HEX(DEC)]:
  232.  
  233. The numbers HEX(DEC) show you the maximum sector number PATCH
  234. will accept.
  235. For files, this is the last sector in the file.
  236. For disks, this is the last sector on the disk.
  237.  
  238. To enter a sector number type the sector number as follows:
  239.  
  240. In Decimal: just type the sector number, then hit enter.
  241.  
  242. In Hexadecimal:
  243.  
  244. If the sector number has an alphabetic character (A-F),
  245. just enter the sector number, then hit enter.
  246.  
  247. If the sector number does not have an alphabetic character in it,
  248. just precede the sector number with an H (If you don't include
  249. the H, PATCH will assume the sector number is in decimal).
  250.  
  251. When a wrong entry has been made, and the enter key has not yet
  252. been pressed, there are two editting keys you can use.
  253. The backspace can be used to delete the previous character.
  254. The HOME key can be used to delete the whole entry.
  255.  
  256. If after hitting Alt-S you decide you don't want to enter a
  257. sector number, you can hit escape to continue patching where
  258. you left off.
  259.  
  260. When PATCH has determined your entry is bad, it will display
  261. an error message and beep at you, it will then let you re-enter
  262. the sector number.
  263.  
  264. BUGS !
  265.  
  266. PATCH has been in use for some time now, and hopefully most of
  267. the bugs have been found and resolved.  If you should discover
  268. a bug, we  will  work with  you to resolve  it.  This does not
  269. imply that  you will  automatically receive  updates of  PATCH
  270. as new versions are released.
  271.  
  272. To report a bug:
  273.  
  274. To report a bug, fill out the bug report form at the end
  275. of this manual.  Be sure to  fill in the serial number.
  276.  
  277. Mail the completed form to:    MicroLife
  278.                                PO Box 340
  279.                                Jessup, MD   20794
  280.  
  281.                                Attn: Jerry W. Shipman
  282. *********************************************
  283. This program uploaded by Jerry shipman to   *
  284. Capital PC Software Exchange.               *
  285. This program is not to be sold for profit.  *
  286. *********************************************
  287.